home *** CD-ROM | disk | FTP | other *** search
/ Aminet 37 / Aminet 37 (2000)(Schatztruhe)[!][Jun 2000].iso / Aminet / util / boot / RemAPollo.lha / RemAPollo.doc < prev    next >
Text File  |  2000-04-24  |  30KB  |  710 lines
  1.                                 RemAPollo V1.4
  2.  
  3.                        Eccentric Creations (TM) Product
  4.  
  5.                  (c) Mikolaj Calusinski 1998-2000. Freeware.
  6.  
  7.                                  User Manual
  8.  
  9. Introduction
  10. ------------
  11.  
  12. RemAPollo - A1200 040\060 MMU Apollo Turboboard Remapper is freeware but
  13. copyrighted software. It has been written as a result of my depression arising
  14. from the sad fact that no working MMU remapper program was available for
  15. Apollo board. We, Apollo users, were in worse position than our Blizzard
  16. owning friends; they are able to modify their Kickstart ROMs as easily as
  17. setting one jumper on their board. We couldn't do that - our boards have no
  18. dedicated jumpers and there were no software to support us in our Kickstart
  19. changing needs. But, hopefully, this inequality will end now thanks to
  20. RemAPollo.
  21.  
  22. Please, notice the fact, that although RemAPollo is no longer BETA, bugs are
  23. always possible. Please contact me in case of any trouble caused by remapper;
  24. detailed bug reports are welcome. For contact address see 'Author' section
  25. below. Also, be sure to carefully read this manual!
  26.  
  27. Distribution
  28. ------------
  29.  
  30. RemAPollo package may be distributed freely, providing the following criteria
  31. are met:
  32.  
  33.  - None of the files in the RemAPollo distribution archive may be modified or
  34.    omitted.
  35.  
  36.  - No money is charged for it apart from media and small handling fee.
  37.  
  38.  - RemAPollo package may be included in freely distributable software
  39.    libraries, but it CANNOT appear on commercial CD-ROMs (including all kind
  40.    of coverdiscs). If you want to include RemAPollo on your CD-ROM you must
  41.    ask for my permission first. This does not apply to AminetCD series;
  42.    Administrator of Aminet, Urban MÜller, has my full permission to place
  43.    RemAPollo package on AminetCD.
  44.  
  45.  - RemAPollo may not be bundled with any commercial hardware or software
  46.    product without prior written consent from me.
  47.  
  48. Disclaimer
  49. ----------
  50.  
  51. YOU USE RemAPollo FILES TOTALLY ON YOUR OWN RISK. I TAKE NO RESPOSIBILITY FOR
  52. ANY DAMAGE CAUSED BY USING RemAPollo PACKAGE.
  53.  
  54. What is that actually for?
  55. --------------------------
  56.  
  57. RemAPollo is a software package for users of Amiga 1200 computer equipped with
  58. 040/060 Apollo Turboboard. It consists of a few files which can be used to
  59. remap ROM part of Amiga Operating System, known as Kickstart, to fast memory
  60. and boot the computer from it. You can move your physical ROM to fast memory
  61. just to gain more speed or you can use wholely different Kickstart image
  62. (especially useful if you are a developer). For more details see Usage
  63. section.
  64.  
  65. Files
  66. -----
  67.  
  68. RemAPollo package consists of the following files:
  69.  
  70. - 68060.pch - patch file for 68060.library, version 60.02 to version 60.10
  71. - Converter - command used to convert BlizKick modules (of no patch type) to
  72.   RemAPollo compatible format.
  73. - CopyIDEfixPrefs - a little command used to copy new IDEFix prefs file to
  74.   IDEfix executable. Can be used by those who want to load IDEfix via MODULES
  75.   option of RemAPollo
  76. - DRAP - Apollo Remapper Deallocator
  77. - FakeLOCAL - this hackish program is to force Apollo fast memory attributes
  78.   to report LOCAL bit set (on 3.x Kickstart also KICK bit is set) on
  79.   coldstart. Thanks to it most of the residents will load itself to fastmem.
  80.   NOTE: This is a HACK and can be used ONLY along with RemAPollo program! For
  81.   experienced users ONLY! You should well understand meaning of LOCAL bit to
  82.   use this! Beware!
  83. - KingCON-handler.pch - spatch patch for KingCON-handler 1.3, 020+ version to
  84.   make KingCON resident installable (thus replacing original con-handler
  85.   completely)
  86. - KReader - a short command for saving current Kickstart to file
  87.   ram:Kickstart
  88. - LoadResident - CLI command for loading resident modules; can be used to
  89.   add files to resident list without the need of re-running RemAPollo. Two
  90.   switches can be specified: FORCEFAST (forces allocations for modules to fast
  91.   memory; can be used to check if your modules will operate from fastmem) and
  92.   REBOOT (resets the Amiga after 1 sec)
  93. - Modules/noclick - updated version of BlizKick patch module, which turns off
  94.   floppy drive clicking
  95. - Modules/noclick.s - source code to this module
  96. - patch - special patcher for 68040/60.library
  97. - RemAPollo - main remaper program
  98. - RemAPollo.doc - this doc
  99. - RemAPollo.doc.info
  100. - RemAPollo.doc.pl - Polish version of manual
  101. - RemAPollo.doc.pl.info
  102. - RemAPollo.info - cute icon (by my brother Jack :)
  103. - RemAPollo.readme - short Aminet description
  104. - Reset - reset tool
  105. - RUX - OS3.5 ROM Update eXtractor - a little command supporting "one reset at
  106.   cold boot" OS3.5 installation (also see Additional Notes section)
  107.  
  108. Copyrights
  109. ----------
  110.  
  111. Amiga, AmigaOS and Kickstart are Copyright © 1985-1999 Amiga International,
  112. Inc.
  113. BlizKick is Copyright © 1996-1999 PitPlane Productions.
  114. Fusion is Copyright ©1997 By Jim Drew & Microcode Solutions
  115. IDEfix is Copyright 1993 - 1999 Elaborate Bytes, Oliver Kastl.
  116. KingCON-handler is Copyright © 1993,1994 David Larsson
  117. RemAPollo is Copyright © 1998-1999 Mikolaj Calusinski.
  118. ShapeShifter is © Copyright 1993-1999 Christian Bauer.
  119. spatch is Copyright © 1992 SAS Institute, Inc.
  120.  
  121. Requirements
  122. ------------
  123.  
  124. For proper operation of RemAPollo package you require:
  125.  
  126. - an Amiga 1200 or 4000 (see Bugs section!)
  127.  
  128. - at least 2.0 (V36) Kickstart in ROM (this should not be a problem :-)
  129.  
  130. - Apollo 040 or 060 Turboboard (the processor must have fully working MMU)
  131.   loaded with at least 1MB of fast memory
  132.  
  133. - original 040.library from Commodore in versions 37.10 or 37.30 (or OS3.5
  134.   44.2) if you are using 68040 processor or 060.library supplied with the
  135.   board (currently only version 60.10 is supported) if you are using 68060
  136.   processor.
  137.  
  138.  
  139. Installation
  140. ------------
  141.  
  142. Installation, however simple, requires some steps which should be followed
  143. strictly and carefully, else system will almost certainly cause you trouble.
  144. As RemAPollo is not for absolute beginners, there is no installation script
  145. provided - you are required to do all the work by hand.
  146.  
  147.                                       1.
  148.  
  149. First - and this is VERY important - you should patch 040(060).library. In
  150. RemAPollo package there is a special program for this purpose called 'patch'.
  151. If your 040(060).library is located in LIBS: and is not crunched (as it should
  152. be in normal setup) all you have to do is type in a shell window command
  153. 'patch' without any parameters. The program will inform you about results of
  154. its work. Please note that for 68040 processor only original libraries from
  155. Commodore are supported; if you are using newer 3rd party library (probably
  156. from Phase5) you will need to stop to do so or RemAPollo will not work. There
  157. is really no need to use Phase5's libraries with Apollo board, believe me;
  158. they were designed for Blizzard turbos.
  159.  
  160. If your library is crunched, first decrunch it and invoke 'patch' program with
  161. path parameter pointing to this decrunched library. After patch is done you
  162. can recrunch library again.
  163.  
  164. This patch is ABSOLUTELY necessary if you want your system to boot reliably
  165. with mapped Kickstart. Your Amiga may seem to work well without the patch but
  166. this is simply asking yourself for trouble; sooner or later your system may
  167. crash. If you want to know further details see Additional notes section.
  168.  
  169. Some older versions of Apollo060 came with 68060.library in version 60.02
  170. sadly not supported by my patch program (which requires at least 60.10). To
  171. aid users of such a board I included special patch '68060.pch', which should
  172. be applied to the library using SAS/C freely distributable 'spatch' program.
  173. First patch your 68060.library to version 60.10 and then use my patch program
  174. on it.
  175.  
  176.                                       2.
  177.  
  178. After above patch is done, you should copy command 'DRAP' (Apollo Remapper
  179. Deallocator) to your C: directory. Till the version of 1.11 you had to place
  180. a call for it in the very first line just after SetPatch in your
  181. startup-sequence. Since the version 1.12 of DRAP this is no longer required;
  182. you can invoke it whenever you want - preferably as a first command. Here
  183. comes recommended beginning of startup-sequence:
  184.  
  185. ...
  186. DRAP
  187. If WARN
  188. RemAPollo MAC QUIET
  189. EndIf
  190. SetPatch QUIET
  191. ...
  192.  
  193. This little program is not absolutely necessary for proper operation of system
  194. with remapped Kickstart but its use is very strongly encouraged. It will free
  195. some memory used by remapper during boot (67720 bytes to be exact) and
  196. generally restore the system to more stable and efficient state. If you intend
  197. to use MAC patch (see Usage) this program *MUST* be run or Fusion will crash.
  198. Its use will also speed up system a bit as it moves first page of memory,
  199. which contains absolute location 4 and happens to be in slooow chip mem, to
  200. fast memory. Finally, DRAP will writeprotect mapped Kickstart. You can keep
  201. its invocation in startup-sequence all the time - even when you want to boot
  202. directly from your ROM Kickstart without the help of remapper - as it will do
  203. exactly nothing (except setting return code to 5 [WARN]) while relocation is
  204. not active.
  205.  
  206. As of version 1.8 there is a little more control over DRAP activities. You can
  207. invoke it without any parameters (recommended) or you can issue any
  208. combination of two new switches: ND=NODEALLOC or RH=RESTOREHANDLER.
  209.  
  210. The first one is used to prevent DRAP from deallocating memory (67720 bytes)
  211. used for temporary MMU tables. These tables are no longer needed as soon as
  212. 68040.library installed its own MMU tree, so most of the time you should not
  213. specify this switch. However if you think you cannot live without a statram
  214. ramdisk (SDx:) or have problems with improperly written resident software
  215. (SIMBug is a good example) you should use NODEALLOC. You will not get back
  216. 67720 bytes of fast memory (who cares these times) but your SD0 will work as
  217. usual.
  218.  
  219. The second parameter (RESTOREHANDLER) can be specified to order DRAP to
  220. restore original value of CPU Bus-Error handler. This is not recommended,
  221. since after using this switch all attempts of writing to ROM area (which is
  222. stupid BTW, but can happen accidentally) will cause a GURU on normal setup
  223. (without Enforcer running).
  224.  
  225. As of version 1.12 a slightly new way of initialization has been introduced to
  226. DRAP - it can now open 68040\60.library, so there is now no requirement to
  227. load it after SetPatch. Also, a new NR (NOREMAP) switch has been added; it can
  228. be used to switch off remapping of zero memory page from chip to fast ram.
  229. Additionally improved compatibility of this operation. See bugs section for
  230. more explanation.
  231.  
  232.                                       3.
  233.  
  234. When two above steps are completed, you can finally use the remapper itself.
  235. See Usage.
  236.  
  237.  
  238. Relocation will survive between resets as long as exec base remains valid and
  239. ColdCapture vector is not changed. To get rid of the resident and return to
  240. original ROM Kickstart just use supplied 'Reset' command with HARD parameter.
  241. It will clear execbase pointer thus removing all resident code from your
  242. system.
  243.  
  244. Usage
  245. -----
  246.  
  247. RemAPollo main program can be invoked from both environments: CLI and WB.
  248. WB tooltypes are almost identical to CLI parameters, so let's discuss the
  249. latter.
  250.  
  251. Standard template (can be obtained via use of question mark) looks like this:
  252.  
  253. KICKFILE,MAC/S,NF=NOPAGEFIX/S,IMJ/S,FORCE/S,QUIET/S,USE=USEKICKPTRS/S,MODULES/
  254. K/M/F:
  255.  
  256. None of parameters is required. If you do not supply any parameters, current
  257. ROM Kickstart will be remapped, patched and the computer will perform reset.
  258. You will boot with the same Kickstart as in ROM, but with one very useful
  259. difference: remapper patches Kickstart in such a way, that fast memory is
  260. usable to the system very early. Thanks to it exec can use this fast memory
  261. for early initialization, placing there own library base and supervisor
  262. stack, so you no longer need patches like FastExec. Additionally you are able
  263. to mount recoverable ramdrives (RADs) in fast memory!
  264.  
  265. KICKFILE parameter is used to specify location of optional Kickstart image
  266. file you want your computer to boot from and operate on. Only 512KB images
  267. with $1114 header or 256KB images with $1111 header and a correct checksum are
  268. supported. Since release 1.4 RemAPollo can be used to remap pre-2.0 (256KB)
  269. Kickstarts.
  270.  
  271. Since version 0.994 of RemAPollo Kickstart files can be compressed.
  272. Decompression is done via xfdmaster.library so make sure you have installed it
  273. if you want to pack your Kick files.
  274.  
  275. MAC - use this switch to reserve first 16KB of chip memory as required by
  276. Fusion, Apple Macintosh software emulator for Amiga. You will not need to use
  277. any RsrvCold, RsrvWarm or PrepareEmul-like tools in your startup-sequence
  278. then. Naturally, this switch allows proper operation of ShapeShifter as well.
  279. Do not forget to run 'DRAP' command after SetPatch though!
  280.  
  281. NF or NOPAGEFIX - this parameter is only useful with 2.x Kickstart images; on
  282. versions 3.x is completely ignored. It is used to switch off fixing of the
  283. first memory page performed automatically on 2.x Kickstarts by remapper. On
  284. those Kickstarts, chip memory is linked to system memlist from location $400.
  285. Because 040/060 processors have MMU page resolution of at least 4kb, it is
  286. better to start chip memory from adequately aligned location such as $1000.
  287. Mapper does this by properly fixing exec initialization routines; starting
  288. from Kickstart 3.0 the fix is no longer necessary as it is performed already
  289. by Kickstart itself. If, for some reason, you do not want to change original
  290. behaviour of 2.x Kickstarts regarding chip memory init, specify NOPAGEFIX.
  291. This parameter is overridden by the use of MAC switch.
  292.  
  293. FORCE - specify this if you want to remap Kickstart in spite of the fact, that
  294. relocation is already active. Normally, remapper will not try to start mapping
  295. process when it detects that this has been done already (so you can use mapper
  296. in your startup-sequence without looping reboots).
  297.  
  298. QUIET - ideal option for those, who want to use remapper permanently in
  299. startup-sequence. It stops all text output from RemAPollo and shortens delay
  300. before rebooting.
  301.  
  302. ---> As of version 1.12 a new IMJ option has been added; it can be used to
  303. disable MEM jumper of the board (so the fast memory always will be visible).
  304.  
  305.  
  306. You can abort remapping process while not in quiet mode by pressing standard
  307. CTRL-C break.
  308.  
  309. *****************************************************************************
  310. **** WARNING! THE FOLLOWING SECTION IS FOR ADVANCED USERS ONLY! WARNING! ****
  311. *****************************************************************************
  312.  
  313. ---> As of version 0.980ß a new MODULES option has been added:
  314.  
  315. MODULES - this keyword can be used to specify optional files, you want to make
  316. resident in one go with the Kickstart. If used, it *MUST* appear as a very
  317. last option in commandline. The number of files is limited only by available
  318. memory (and commandline length). You can supply here any file, which contains
  319. a valid resident ROMTAG structure (for example: most libraries and
  320. filesystems). Additionally, it can be used to make IDEFix reset resident (see
  321. Bugs section for some oddities).
  322.  
  323. From version 0.996 you can use BlizKick modules with RemAPollo! These come in
  324. two types: patch and extresbuf. Patch ones can be applied directly using
  325. MODULES option, while extresbuf-type require converting prior to installation.
  326. Use supplied program 'Converter' to fix them.
  327.  
  328. From version 1.2 you are no longer required to enter full path to modules each
  329. time if they are located in the same directory. For example let's assume you
  330. want to load three BlizKick modules located in DEVS:Mods/ directory. In old
  331. versions you had to type something like this:
  332.  
  333. "...MODULES DEVS:Mods/noclick DEVS:Mods/FixMath404 DEVS:Mods/ramlibstack"
  334.  
  335. Since 1.2 version you must enter the path only first time:
  336.  
  337. "RemAPollo MODULES DEVS:Mods/noclick FixMath404 ramlibstack"
  338.  
  339. ---> As of version 0.991ß a new USEKICKPTRS option has been added:
  340.  
  341. USE or USEKICKPTRS - this switch forces remapper to use current KickTag and
  342. KickMem residents list. Thanks to this option you can use other resident
  343. programs and still have only one reset at coldstart. To make this work you
  344. have to run these additional programs BEFORE RemAPollo and you should
  345. configure them to not perform reset! For exaple - if you need to use
  346. BootControl proram by Oliver Kastl and want to have only one reboot at start,
  347. you should place the following in your startup-sequence:
  348.  
  349. BootControl INSTALL        ;NOTE: there's no 'BOOT' switch used!
  350. RemAPollo DEVS:Kick3.1 MAC QUIET USE    ;USE makes the mapper see BootControl
  351. SetPatch QUIET
  352. DRAP
  353. ...
  354.  
  355. Please note that all the residents installed this way will be placed in LOCAL
  356. memory which on most systems means chip memory. To overcome this I wrote a
  357. little hack program, called FakeLOCAL. This program should be placed as a
  358. very first command in your startup-sequence, so the above example will look
  359. like this:
  360.  
  361. FakeLOCAL
  362. BootControl INSTALL        ;NOTE: there's no 'BOOT' switch used!
  363. RemAPollo DEVS:Kick3.1 MAC QUIET USE    ;USE makes the mapper see BootControl
  364. SetPatch QUIET
  365. DRAP
  366. ...
  367.  
  368. Now, the BootControl program will load into Apollo fast memory.
  369.  
  370. NOTE: FAkeLOCAL is a HACK and can be used ONLY along with RemAPollo program!
  371. For experienced users ONLY! You should well understand meaning of LOCAL bit to
  372. use this! Beware!
  373.  
  374. *****************************************************************************
  375. *****************************************************************************
  376. *****************************************************************************
  377.  
  378. If you need an example - I use the following phrases in start of my
  379. startup-sequence:
  380.  
  381. DRAP
  382. If WARN
  383. FakeLOCAL    ;I use this only because of MountCD below!
  384. MountCD CD0 QUIET
  385. RemAPollo MAC QUIET USE MODULES C:IDEfix L:KingCON-handler FastFileSystem
  386. EndIf
  387. SetPatch QUIET
  388.  
  389. I have 3.1 ROMs so no need to specify Kickstart image, but if you use 3.0, you
  390. can issue something like this:
  391.  
  392. RemAPollo DEVS:Kickstart3.1 MAC QUIET MODULES c:IDEFix L:FastFileSystem
  393.  
  394. Of course, you must have appropriate Kickstart image file in DEVS: to do this.
  395.  
  396. Additional Notes
  397. ----------------
  398.  
  399. Resident code of RemAPollo is protected with checksum to assure proper booting
  400. - program will turn the screen red and hard reset the machine when any change
  401. in resident segment is found.
  402.  
  403. Mapper uses ColdCapture vector to survive between reboots, so you should not
  404. run any other programs which make use of this vector. Also, CPU Bus Error
  405. vector ($00000008) is replaced and should remain in this state until SetPatch
  406. opens 68040(60).library. After that you should run DRAP command which restores
  407. this vector to original (NOTE: as of version 1.8 of DRAP the vector is not
  408. restored by default. You can force its restoration by 'DRAP RH'). Take above
  409. facts into account when examining system with antivirus program.
  410.  
  411. To allow Kickstart mapping, RemAPollo must build MMU translation tables which
  412. consume some memory. I tried to limit amount of this memory as much as
  413. possible, so mapper uses 8KB MMU pages. Unfortunately, this design conflicts
  414. with the way Commodore's 040.library and Apollo's 060.library install their
  415. own 4K tables. These libraries do not switch MMU off before loading root
  416. pointers resulting in unpredictable system behaviour. Look at this code from
  417. 040.library in version 37.30:
  418.  
  419. (following routine is entered with enabled MMU in 8K mode, as done by mapper)
  420.  
  421.     ori.w    #$700,SR
  422.     pflusha
  423.     move.l    (A0)+,D0
  424.     movec    D0,URP        ;!!! URP points to 4K tables!!!
  425.     move.l    (A0)+,D0
  426.     movec    D0,SRP        ;!!! SRP points to 4K tables!!! - BOOOM!
  427.     move.l    (A0)+,D0
  428.     movec    D0,TC        ;MMU is switched to 4K mode, little late...
  429.     pflusha
  430.     moveq    #0,D0
  431.     movec    D0,ITT0
  432.     movec    D0,ITT1
  433.     movec    D0,DTT0
  434.     movec    D0,DTT1
  435.     rte
  436.  
  437. To work properly, above routine should start with something like this...
  438.  
  439.     ori.w    #$700,SR
  440.     moveq    #0,d0
  441.     movec    d0,TC        ;switch MMU off
  442.     pflusha
  443.  
  444. ...and that's exactly what does the 'patch' program.
  445.  
  446. NOTE: If you are going to remap Kickstart from file, please make sure you have
  447. a proper version of it! The file must contain image of Kickstart which is in
  448. original, unmodified form and designed to work on your computer. So, if you
  449. have an Amiga A1200, RemAPollo cannot be used with A4000's (40.7x) kickfiles.
  450.  
  451.                                      ***
  452.  
  453. OS3.5 users, read below:
  454.  
  455. You have probably wondered if RemAPollo could be used with OS 3.5 update. Fear
  456. not, it can. All versions of RemAPollo are compatible with this latest OS
  457. update and there should be no problems as well with possible future OS
  458. releases. However, current 1.3 release of RemAPollo goes even further to aid
  459. you with transparent OS3.5 installation. There is a special 'RUX' tool
  460. included, which can be used to extract some OS3.5 modules from file 'AmigaOS
  461. ROM Update' (usually placed in DEVS:) obsoleting default SetPatch
  462. installation. RUX comes with the following command line options:
  463.  
  464. FILE,A600/S,A1200/S,A3000/S,A4000I/S,A4000S/S
  465.  
  466. FILE - specifies location of 'AmigaOS ROM Update' file (default is to search
  467. in DEVS:)
  468.  
  469. Other switches denote type of machine modules are to be extracted for:
  470.  
  471. A600 - you should never specify this switch, as these modules are designed to
  472.        be compatible with 68000 CPU
  473. A1200 - most of the time this should be the switch of your choice
  474. A3000 - for Amiga 3000
  475. A4000I - for Amiga 4000 if you use only its embedded IDE interface
  476. A4000S - for Amiga 4000T with real SCSI controller
  477.  
  478. So, after using default OS3.5 installer, you can make the following
  479. corrections:
  480.  
  481. 1. make a directory in your LIBS: named, say, OS3.5
  482. 2. move workbench.library and icon.library from LIBS: to LIBS:OS3.5/
  483. 3. remember to MOVE them (so make sure they are not visible in LIBS:)
  484. 4. assuming you have A1200 and 'AmigaOS ROM Update' file is placed in DEVS:,
  485. open yur shell, change current directry to LIBS:OS3.5/ and enter 'RUX A1200'
  486. 5. three files will be created, named OS_Module1 OS_Module2 and OS_Module3 -
  487. these are resident modules you should use with MODULES option of Remapollo
  488. 6. remove 'AmigaOS ROM Update' file from DEVS: (recommended) or use
  489. NOROMUPDATE option of SetPatch
  490.  
  491. Beginning of your startup-sequence should resemble something like this
  492. (customize this according to your setup and liking of course):
  493.  
  494. DRAP
  495. If WARN
  496. ;--------- the following in one line of course
  497. RemAPollo DEVS:Kick3.1 MAC QUIET MODULES LIBS:OS3.5/OS_Module1 OS_Module2
  498. OS_Module3 workbench.library icon.library
  499. ;---------
  500. EndIf
  501. SetPatch QUIET NOROMUPDATE
  502. ...
  503.  
  504. Usually, you can skip first module (OS_Module1) and in case you use IDEFix or
  505. FastATA (PowerFlyer) also skip scsi.device module. You can tell the actual
  506. module name (and real function) from its comment.
  507.  
  508. Thanks to this installation, you will still have only one reset at coldstart.
  509.  
  510.                                      ***
  511.  
  512. Bugs
  513. ----
  514.  
  515. Recoverable ramdisk driven by statram.device (SDx:) will no longer work as
  516. supposed when default installation of RemAPollo has been made. To make it work
  517. again you must invoke DRAP with 'ND' option in startup-sequence.
  518.  
  519. OXYPatcher does not mount its port properly on most systems. It is not my
  520. fault - OXYPatcher is very buggy.
  521.  
  522. As of version 119.11 (3.1) of IDEfix its preferences are no longer stored into
  523. main executable. This is somewhat annoying if you intend to load IDEfix by
  524. MODULES option of RemAPollo. To overcome this I included a little command -
  525. CopyIDEfixPrefs, which copies your prefs from a new SYS:Prefs/IDEfix.prefs
  526. file to the IDEfix executable.
  527.  
  528. If you are the owner of A4000 please make sure you have the first SIMM slot
  529. empty or RemAPollo will not work!
  530.  
  531. I've got several reports stating that RemAPollo does not allow some of old
  532. games to work properly (this applied to so called NDOS-floppy games fixed to
  533. operate on newer CPUs and enhanced with HD loaders). Gfx corruption and
  534. sometimes even crashes were observed. All this mess was caused by DRAP program
  535. default mapping of reserved low chip-memory location to board's fast memory.
  536. Strictly speaking it was not my fault, as no OS-compliant program should use
  537. nonallocated memory. But to enhance compatibility I changed the way DRAP does
  538. the mapping - it should work ok now. If you still experience problems, you can
  539. disable the mapping completely using NR (or NOREMAP) option of DRAP. Please
  540. note howerver, that after using Fusion (Apple Macintosh emulator) you will
  541. have the same problem again, as Fusion remaps whole first 16kb of chip memory
  542. to fastmem by itself. This applies to systems without RemAPollo running as
  543. well.
  544.  
  545.  
  546. History
  547. -------
  548.  
  549. V0.1ALPHA - (??.9.98) - internal hardcoded versions for my own use
  550.  
  551. V0.96ß - (23.12.98) - first semi-public release, to selected betatesters only
  552.  
  553. V0.97ß - (1.1.99) fixes:
  554.  - caches are now invalidated prior enabling
  555.  - only instruction cache is enabled at start
  556.  - resident now checks ROM checksum - hard reset when incorrect
  557.  
  558. V0.973ß - (8.1.99)
  559.  - added fix for $c00000 mem recognition (this should cure yellow-screen
  560.    crashes occuring on some systems). Thanks for Arkadiusz Winiarek and Marcin
  561.    Ostrowski for reporting this.
  562.  
  563. V0.974ß - (12.1.99)
  564.  - added 060 flag to execbase when 060 detected
  565.  
  566. V0.975ß - (13.1.99)
  567.  - better resident code recognition (you can use *polite* programs that grab
  568.    coldcapture vector now). First truly public version.
  569.  
  570. V0.976ß - (26.1.99)
  571.  - changed the header of mapped Kickstart to 'MM' to avoid confusion when
  572.    trying to map Kickstart image processed by Remapollo
  573.  
  574. V0.977ß - (28.1.99)
  575.  - fixed bug in reset routine
  576.  
  577. V0.980ß - (1.2.99)
  578.  - MAJOR: added possibility to install resident modules (like IdeFix, betas
  579.    from AmigaInc., etc.) in one go with the Kickstart
  580.  
  581. V0.981ß - (4.2.99)
  582.  - fixed  mem allocation bugs with modules option
  583.  
  584. V0.982ß - (5.2.99)
  585.  - check for doubling modules
  586.  - some internal changes
  587.  
  588. 0.983ß Thu Feb 11 22:52:40 1999
  589. - WB mode bugs introduced in 0.982 fixed
  590. - added 8 bytes of safety margin to AllocAbs
  591.  
  592. 0.984ß Sun Feb 21 11:26:15 1999
  593. - some serious rewrites to make RA work on A4000 started
  594. - no longer compatible with previous versions (RemAPollo and DRAP)
  595.  
  596. 0.985ß Mon Feb 22 17:42:31 1999
  597. - internal changes in resident segment code
  598. - fixed a few additional serious bugs with MODULES option
  599.  
  600. 0.986ß Fri Mar 05 21:41:59 1999
  601. - fixed serious bug introduced in 0.985 (resident frame)
  602.  
  603. 0.987ß Sat Mar 13 14:41:48 1999
  604. - housekeeping changes & cleanups
  605.  
  606. 0.988ß Mon Mar 15 22:30:16 1999
  607. - housekeeping cleanups
  608. - fixed a long-standing serious bug in bus-error handler (write protect
  609.   violation in Kickstart area caused removal of the mapping)
  610.  
  611. 0.989ß Sat Mar 20 22:01:33 1999
  612. - added special code for A4000 "feature"
  613. - fixed bug in WB mode MODULES option
  614.  
  615. 0.990ß Sun Apr 11 15:19:08 1999
  616. - replaced BSS section by a direct memory allocation
  617.  
  618. 0.991ß Tue Apr 13 15:20:40 1999
  619. - added USEKICKPTRS option
  620.  
  621. 0.993ß Fri Apr 23 21:54:10 1999
  622. - QUIET option is now disabled when fatal error occured
  623. - removed support for A4000 due to technical reasons
  624. - second public Aminet release
  625.  
  626. 0.994ß Wed May 12 13:26:34 1999
  627. - added support for packed Kickfiles (xfdmaster.library)
  628.  
  629. 0.995ß Mon May 17 12:11:18 1999
  630. - rewritten for optimized frames
  631. - again made incompatible with previous releases :)
  632. - restored partial support for A4k; must have first SIMM slot empty for this!
  633.  
  634. 0.996ß Thu Jun 10 11:36:36 1999
  635. - fixed serious bug in 060 version of bus-error handler
  636. - added support for BlizKick modules; patch type only
  637. - fixed bug with modulenames containing space
  638.  
  639. 0.997ß Sun Jun 27 02:24:41 1999
  640. - changed reset routines a little (trying to compensate for Apollo bug)
  641. - rewritten 060 handler; hope this finally fixes all the bugs
  642.  
  643. 1.0 Sun Jul 04 15:44:17 1999
  644. - final (?) release
  645.  
  646. 1.1 Mon Sep 06 22:56:31 1999
  647. - corrected bug with leading spaces in MODULES commandline
  648. - fixed small bugs in resident frame code
  649. - added trace switch for 040 handler and fixed small bug in 060 handler
  650.  
  651. 1.2 Sun Oct 17 17:31:27 1999
  652. - added automatic directory change while loading modules
  653. - fixed bug with modules mem deallocation after ctrl-c
  654. - added IMJ switch
  655.  
  656. 1.3 Sat Dec 25 12:29:54 1999
  657. - restored reset code from 1.0 version; should work with all boards now
  658. - again rewritten parts of bus-error handler
  659.  
  660. 1.4
  661. - MAJOR: added support for Kick1.x
  662. - fixed small bug with modules parser
  663.  
  664.  
  665. Thanks
  666. ------
  667.  
  668. Big thanks must go to Harry Sintonen who sent me some early infos about 040
  669. MMU - it was long ago but they helped me to recognize the problem I intended
  670. to confront with; thanks again mate!
  671.  
  672. Warm kisses to Motorola ;-) for excellent Literature Distribution Center which
  673. provides all the customers with various kinds of printed manuals. For free!
  674. I didn't have to register as a certified developer, issue any monthly fees nor
  675. sign any NDAs just to get access to information. Incredible for people used to
  676. Commodore's policy, but true. ;-)
  677.  
  678. Last (but not least) - thanks to all alfatesters who agreed to risk integrity
  679. of their systems while fighting with numerous versions of RemAPollo
  680. (especially to Marcin Ostrowski for helping me to notice serious bug; hope you
  681. finally will manage to set your system stright again... ;)
  682.  
  683. Special thanks to Olivier Fabre for bugreports and testing new versions of
  684. handler on 060.
  685.  
  686. Also I wish to thank my brother Jacek for Polish version of this manual (I'm
  687. so lazy... :)
  688.  
  689. This program is dedicated to Ministry - the band creating music, not (c)rap.
  690.  
  691. Author
  692. ------
  693. My e-mail address (this is preferred way of contact): bloelle@priv.gold.pl or
  694. bloelle@polbox.com
  695.  
  696.  
  697. For those without inet access:
  698.  
  699.                               Mikolaj Calusinski
  700.                             ul. Olsztynska 113/117
  701.                               42-200 Czestochowa
  702.                                     POLAND
  703.  
  704.  
  705.  
  706. I hope you find this little proggy useful. Have fun!
  707.                                                             Mike.
  708.  
  709.            ------------> AMIGA - THE BEST COMPUTER EVER <------------
  710.